Oklahoma NG911 Toolkit | Prep | Enhancement | Validation | MSAG | Comparison | Submission
Supplementary Documentation | Examples | Topology Rules | Change Log | [Error Glossary]
January 09, 2025
This document lists and describes the various messages written to the geoprocessing console, the TemplateCheckResults table, and the FieldValuesCheckResults table. In cases where the exact text of a message may vary, the contents of the variable part(s) are described in {curly braces}.
Tool Failure Errors are errors that print to the groprocessing console when a tool fails.
Validation Errors describe issues that impede submission. Validation Notices do not impede submission.
RuntimeError: [ArcGIS License Error] {message} - The NG911 tool uses an ArcGIS geoprocessing tool that requires a higher level license. See the documentation for the NG911 tool to see if it can be run with different options that require a lower license level. Otherwise, there is no workaround; a higher ArcGIS license is required.
ExecuteError: {message} - Generated by ArcGIS; may be accompanied by a six-digit error code. These errors may occur if the NG911 tool is being used improperly; refer to the NG911 tool's documentation. If such an error occurs despite proper user of the tool, please report a bug (see Support Contact below).
{error type}: BUG ENCOUNTERED. REPORT TO DEVELOPERS {message continues...} - The script encountered a situation internally that should not have happened. Please report a bug (see Support Contact below) and include all output in the geoprocessing console in the report.
SUBMITError: No feature dataset named 'NG911' exists - The NG911 geodatabase does not contain a feature dataset named NG911. (TemplateCheckResults)
Error: Required layer {feature class name} is not in geodatabase dataset. - A required feature class with the indicated name does not exist in the NG911 feature dataset. (TemplateCheckResults)
If this check generates any errors, a console warning is printed: Not all required geodatabase datasets and/or layers are not present. See TemplateCheckResults.
SUBMITError: Domain Name {domain name} is not an approved domain. - The geodatabase contains a domain with a non-standard name. (FieldValuesCheckResults)
Error: Domain Coded Value '{code}' for {domain name} Domain is incorrect. - A coded value that is not Standards-compliant exists in a domain. (FieldValuesCheckResults)
Error: Domain Coded Value Description '{existing code description}' for {code} coded value in {domain name} Domain is incorrect and should be '{standard code description}'. - The description for a coded value is not Standards-compliant. The descriptions in the message may be abbreviated. (FieldValuesCheckResults)
Notice: Domain Description '{existing domain description}' for {domain name} Domain should be '{standard domain description}'. - The domain description for a Standards-compliant domain name is not Standards-compliant. The descriptions in the message may be abbreviated. (FieldValuesCheckResults)
If this check generates any errors, a console warning is printed: Completed checking GDB domains: {#} issues found. See table FieldValuesCheckResults for results.
SUBMITError: Spatial reference of feature dataset is incorrect. - The NG911 feature dataset does not have the correct spatial reference. (TemplateCheckResults)If this check generates any errors, the above error is also printed to the console as a warning.
SUBMITError: {feature class name} does not have required field {field name} - A field required by the Standards does not exist in a feature class. (TemplateCheckResults)
Error: HNO/Address field of Address Points is not an integer or a double, it is a {field data type} - The data type of the Address field in the ADDRESS_POINT feature class should be numeric. (TemplateCheckResults)
If a required feature class does not exist inside the NG911 feature dataset, a console warning is printed: Required layer {feature class name} does not exist
If this check generates any errors, a console warning is printed: Completed check for required fields: {#} issues found. See table FieldValuesCheckResults for results.
SUBMITError: {field name} is null for Feature ID {NGUID} - A required field is null for a specific feature. (FieldValuesCheckResults)If a feature class does not have a field named SUBMIT, a console warning is printed: Cannot check required field values for {feature class name}
If a feature class is missing one or more required fields, a console warning is printed: Could not check all fields in {feature class name}. Looking for: {list of required fields}
If a feature class has no features where SUBMIT is Y, a console warning is printed: {Feature class name} has no records marked for submission. Data will not be verified.
If a required feature class does not exist inside the NG911 feature dataset, a console warning is printed: Required layer {feature class name} does not exist
If this check generates any errors, a console warning is printed: Completed check for required field values: {#} issues found. See table FieldValuesCheckResults for results.
SUBMITError: {feature class name} has 0 records for submission - A required feature class has no features where SUBMIT is Y. (TemplateCheckResults)If a feature class does not have a field named SUBMIT, a console warning is printed: SUBMIT field does not exist in required layer {feature class name}
If a required feature class does not exist inside the NG911 feature dataset, a console warning is printed: Required layer {feature class name} does not exist
If this check generates any errors, a console warning is printed: One or more layers had no features to submit. See table TemplateCheckResults.
SUBMITError: Invalid geometry - A feature does not contain the minimum necessary number of points per its indicated geometry. (Point: ≥1, Line: ≥2, Polygon: ≥3) (FieldValuesCheckResults)If a feature class has no NGUID field, a console warning is printed: NGUID field {field name} does not exist in {feature class name}
If a required feature class does not exist inside the NG911 feature dataset, a console warning is printed: Required layer {feature class name} does not exist
If this check generates any errors, a console warning is printed: Completed for invalid geometry: {#} issues found. See FieldValuesCheckResults.
SUBMITError: Value {field value} not in approved domain for field {field name} - A field contains a value (other than null or an empty string) that is not in the Standards-compliant domain. (FieldValuesCheckResults)
Error: Value {field value} not in approved domain for field {field name} - The value of the Address field is either less than 0 or greater than 999999. (FieldValuesCheckResults)
If a feature class has no features where SUBMIT is Y, a console warning is printed: No features are marked for submission in {feature class name}. Please mark records for submission by placing Y in the SUBMIT field.
If a feature class does not have a field named SUBMIT, a console warning is printed: Cannot check required field values for {feature class name} because the SUBMIT field does not exist.
If a feature class is missing one or more fields with domains, a console warning is printed: Field {field name} in feature class {feature class name} does not exist, and its values cannot be checked against domain {domain name}.
If a required feature class does not exist inside the NG911 feature dataset, a console warning is printed: Required layer {feature class name} does not exist
If this check generates any errors, a console warning is printed: Completed checking fields against domains: {#} issues found. See table FieldValuesCheckResults for results.
SUBMITError: Feature not inside discrepancy agency boundary - A feature was found to not be within any DISCREPANCYAGENCY_BOUNDARY feature, and the feature does not have a TopoExcept value of INSIDE_EXCEPTION or BOTH_EXCEPTION (if applicable). Detailed information on topology rules involving the DISCREPANCYAGENCY_BOUNDARY feature class can be found in the NG911 Topology Rules documentation. (FieldValuesCheckResults)If neither DISCREPANCYAGENCY_BOUNDARY (in the NG911 feature dataset) nor COUNTY_BOUNDARY (in the OptionalLayers feature dataset) exist, a console warning is printed: Check Feature Locations could not run because the discrepancy agency and/or county boundary feature classes are absent or misnamed.
If this check generates any errors, a console warning is printed: {Feature class name}: issues with some feature locations
If this check generates any errors, a console warning is printed: Completed check on feature locations: {#} issues found. See table FieldValuesCheckResults.
SUBMITError: Both origin and destination feature class names are null. - Both Origin and Destination feature class name fields in an error feature class are None, a blank string, or a space. (FieldValuesCheckResults)
Error: Topology issue- {topology rule} | Number of errors- {#} - A topology rule was violated, and the violating feature was not marked as an exception with its TopoExcept field (if applicable). Detailed information on topology rules can be found in the NG911 Topology Rules documentation. (FieldValuesCheckResults)
If this check generates any errors, a console warning is printed: Topology check complete. {#} issues found. Results in FieldValuesCheckResults.
SUBMITError: {NGUID} is a duplicate ID - The same NGUID was found on multiple records (i.e. that unique ID is not unique). (FieldValuesCheckResults)
Error: Unique ID format wrong. - The unique ID is not in the Standards-compliant format. (FieldValuesCheckResults)
Error: {#} records with null Unique IDs. - One or more features have a null* unique ID attribute. (FieldValuesCheckResults)
If a required feature class is not found, a console warning is printed: {Feature class name} does not exist
If this check generates any errors, a console warning is printed: There are {#} records in {feature class name} with null or incorrectly-formatted unique IDs.
If this check generates any errors, a console warning is printed: Checked unique ID frequency. There were {#} issues. Results are in table FieldValuesCheckResults.
If the ADDRESS_POINT feature class was not found in its expected location, a console warning is printed: Layer ADDRESS_POINT does not exist and therefore cannot be checked. This will prevent submission.
SUBMITError: {MSAGComm field name} has a leading or trailing space. - A feature's MSAGComm, MSAGComm_L, or MSAGComm_R attribute begins or ends with a space. MSAGComm, MSAGComm_L, and MSAGComm_R attributes should consist neither of a space followed by one or more characters nor of one or more characters followed by a space. (FieldValuesCheckResults)
Notice: {MSAGComm field name} is a blank string or has only a space. - A feature's MSAGComm, MSAGComm_L, or MSAGComm_R attribute is not null, but consists of a text string either with no characters or with a single space as the only character. (FieldValuesCheckResults)
If this check generates any errors, a console warning is printed: Check complete. {#} issues found. See table FieldValuesCheckResults for results.
SUBMITError: RCLMatch is reporting a NENA Unique ID that does not exist in the road centerline - The RCLMatch attribute of an ADDRESS_POINT feature is not null, but there is no ROAD_CENTERLINE feature with that NGUID_RDCL attribute. (FieldValuesCheckResults)
Error: RCLMatch does not correspond to a NENA Unique ID that matches attributes - The matching ROAD_CENTERLINE feature's street-name-related or MSAGComm attributes don't match those of the ADDRESS_POINT feature. (FieldValuesCheckResults)
Error: Address does not fit in range of corresponding RCLMatch - The ADDRESS_POINT feature's Address attribute is not within the matching ROAD_CENTERLINE feature's address range (defined by Add_L_From, Add_L_To, Add_R_From, Add_R_To). (FieldValuesCheckResults)
Error: Road segment address ranges include one or more null values - One or more of the matching ROAD_CENTERLINE feature's Add_L_From, Add_L_To, Add_R_From, and Add_R_To attributes are null instead of numeric. (FieldValuesCheckResults)
Error: RCLSide is null - The ADDRESS_POINT feature's RCLSide attribute is null. (FieldValuesCheckResults)
If the ADDRESS_POINT feature class does not have an RCLMatch field, a console warning is printed: Missing required field RCLMatch.
If this check generates any errors, a console warning is printed: Check complete. {#} issues found. See table FieldValuesCheckResults for results.
SUBMITError: Frequency table exists; please delete or close and rerun the check. - The frequency table exists, and the tool failed to delete it. (FieldValuesCheckResults)
Error: {NGUID} has duplicate field information - A record has a combination of certain attributes identical to that of another record where this combination should be unique. For example, an error involving an ADDRESS_POINT feature means there are multiple features represent the same address. (FieldValuesCheckResults)
Error: Could not complete duplicate record check. {Error technical information} - The program encountered an execution error. (FieldValuesCheckResults)
Notice: {NGUID_RDCL} has duplicate address range information - Multiple ROAD_CENTERLINE features have one or more of their Add_L_From, Add_L_To, Add_R_From, and Add_R_To attributes that are identical. (FieldValuesCheckResults)
If the frequency table (AP_Freq or Road_Freq) exists and the script cannot delete it, a console warning is printed: Please manually delete {frequency table name} and then run the frequency check again.
If the Address field of the ADDRESS_POINT feature class is not of type Integer or Double, a console warning is printed: Address field of Address Points is not an integer or a double field.
If this check generates any errors, a console warning is printed: Checked frequency. There were {#} duplicate records. Individual results are in table FieldValuesCheckResults
SUBMITNotice: Address point {OBJECTID} does not match {either "ESN" or "City"} in {either "ESZ_BOUNDARY" or "MUNICIPAL_BOUNDARY"} layer. - (FieldValuesCheckResults)
Notice: Address point with OBJECTID {OBJECTID} does not have a NENA Unique ID. Its {either "ESN" or "City"} attribute was not checked against its containing {either "ESZ_BOUNDARY" or "MUNICIPAL_BOUNDARY"} polygon. - (FieldValuesCheckResults)
Notice: ESN/Municipality check did not run. {Error technical information} - The program encountered an execution error. (FieldValuesCheckResults)
If the ADDRESS_POINT feature class was not found in its expected location, a console warning is printed: {Input path to ADDRESS_POINT} does not exist
If the ESZ_BOUNDARY feature class was not found in its expected location, a console warning is printed: ESZ layer does not exist. Cannot complete check.
SUBMITError: {Next-Gen field name} value {Next-Gen field value} does not match {Legacy field name} value {Legacy field value}. - There is a mismatch between the fully-written-out value in the Next-Gen field and the abbreviation in corresponding Legacy field. For example, a record with a StreetType attribute of AVENUE and a LgcyType attribute of BLVD would result in this error. (FieldValuesCheckResults)If this check generates any errors, a console warning is printed: Completed checking NG against Legacy field values: {#} issues found. See table FieldValuesCheckResults for results.
SUBMITSee entry in Address Point Validations section.
SUBMITSee entry in Address Point Validations section.
SUBMITNotice: This segment might contain a geometry cutback. - A ROAD_CENTERLINE polyline feature has two adjacent segments that form an angle sharper than 55°. This may indicate a data error, or it may simply represent a road with an exceptionally sharp curve. (FieldValuesCheckResults)If the ROAD_CENTERLINE feature class was not found in its expected location, a console warning is printed: {Input path to ROAD_CENTERLINE} does not exist
If this check generates any notices, a console warning is printed: Completed check on cutbacks: {#} issues found. See FieldValuesCheckResults.
SUBMITNotice: Segment's address range is from high to low instead of low to high - For the indicated feature, Add_L_From > Add_L_To and/or Add_R_From > Add_R_To instead of the other way around. (FieldValuesCheckResults)If this check generates any notices, a console warning is printed: Completed road directionality check. There were {#} issues. Results are in table FieldValuesCheckResults.
SUBMITNotice: {MSAGComm field} needs to be a real value - The value of MSAGComm_L or MSAGComm_R (as specified in the notice) is null*. (FieldValuesCheckResults)
Notice: {NGUID_RDCL} has an overlapping address range. - A ROAD_CENTERLINE feature overlaps an address range of another feature. (FieldValuesCheckResults)
If this check generates any notices, a console warning is printed: {#} overlapping address range segments found. Please see {full path to AddressRange_Overlap output} for overlap results.
SUBMITError: Could not process parity check. Look for null values. - One or more parity attributes are null. (FieldValuesCheckResults)
Error: Could not process parity check for a road segment with a null unique ID. - A ROAD_CENTERLINE feature has a null unique ID, and a parity report could not be created. (FieldValuesCheckResults)
Error: One or more address ranges are null - One or more address range attributes are null. (FieldValuesCheckResults)
Notice: {"L" or "R"} Side- Address range is 0-0, but the parity is recorded as {parity type} instead of Z - The address range from and to attributes are both 0, so the parity should be set to Z (zero). (FieldValuesCheckResults)
Notice: {"L" or "R"} Side- Parity is Z (zero), but the address range is filled in with non-zero numbers. - One or more address range attributes are non-zero, but the corresponding parity attribute is Z (zero). (FieldValuesCheckResults)
Notice: {"L" or "R"} Side- Parity is marked as {parity type} but the ranges filled in are {parity type} and {parity type} - The parity attribute does not match the actual parities of the address range attributes. (FieldValuesCheckResults)
Notice: A wild error appeared! The wild error used {generic video game attack move}! It's a one-hit KO! {Message} - The developers do not expect this situation to ever occur, but if it does, please email the support contacts listed below. (FieldValuesCheckResults)
If any ROAD_CENTERLINE feature's Parity_L or Parity_R attribute is null, a console warning is printed: You have one or more parities set as null. Please populate those fields.
If this check generates any errors, a console warning is printed: Completed parity check. There were {#} issues. Results are in table FieldValuesCheckResults.
SUBMITError: {Next-Gen field name} unabbreviated value {Next-Gen field value} does not match {Legacy field name} abbreviated value {Legacy field value}. - There is a mismatch between the fully-written-out value in the Next-Gen field and the abbreviation in corresponding Legacy field. For example, a record with a StreetType attribute of AVENUE and a LgcyType attribute of BLVD would result in this error. (FieldValuesCheckResults)If this check generates any errors, a console warning is printed: Completed checking NG against Legacy field values: {#} issues found. See table FieldValuesCheckResults for results.
Where "null" is followed by an asterisk, "null" refers to any of the following: SQL NULL, Python None, a blank string (''), or a string consisting only of a single space (' ').
For issues or questions, please contact through email Riley Baird at rbaird@odot.org or Emma Baker at ebaker@odot.org with the Oklahoma Transportation Cabinet, and please include in the email which script you were running, any error messages, and a zipped copy of your geodatabase. Change the file extension from zip to piz so it gets through the email server. If there are further data transfer issues, contact Emma or Riley to make alternative data transfer arrangements.
The Oklahoma NG9-1-1 GIS Toolbox is provided by the Oklahoma Geographic Information (GI) Council, Oklahoma 9-1-1 Management Authority, Oklahoma Department of Transportation (ODOT), Oklahoma Office of Geographic Information (OGI) , and associated contributors "as is" and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. In no event shall the Oklahoma GI Council, Oklahoma 9-1-1 Management Authority, ODOT, OGI, or associated contributors be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this software, even if advised of the possibility of such damage.